home *** CD-ROM | disk | FTP | other *** search
/ United Public Domain Gold 2 / United Public Domain Gold 2.iso / utilities / pu386.dms / pu386.adf / KiteSim.Doc next >
Text File  |  1988-01-27  |  10KB  |  293 lines
  1. *************************************************************
  2.  
  3.                KiteSim v2.42 - The Kite Simulator
  4.  
  5.           (c) R.Boardman of Wavelength Software 1993
  6.  
  7.                           __/\  __
  8.                               \/
  9.  
  10.                This version 22nd August 1993
  11.  
  12. *************************************************************
  13.  
  14.  Commodore-Amiga    //
  15.     A1200 OK      \X/
  16.  
  17.  
  18.  
  19. What is KiteSim?
  20. ================
  21.  
  22.   Well, KiteSim is, as the name implies, a kite simulator - i.e. it
  23. simulates the paths of kites as they move through the air. As yet they
  24. just do a loop (or as near as they get within the set time limit).
  25.   As this is the first release, but one of many revisions, what it can
  26. do is fairly limited. When all of the variables have been user set, you
  27. can see a star-filled sky (yes, even in the day-time - there is still
  28. a small bug which I will fix in the next version). On this screen you
  29. will see a list of variables (kite area doesn`t work on-screen) about
  30. the current kite.
  31.   Also on the screen you will see the kite (surprise, surprise!) with
  32. two or more kite lines coming down from it. The kite will start to do
  33. a loop (the larger kites take a long time and the movement is jerky)
  34. within the time limit. Pressing the left mouse button just after it
  35. redraws the kite will abort the current kite's flight.
  36.   When finished you can press the right mouse button to restart, or the
  37. left mouse button to give a printout and restart.
  38.   Pressing <Ctrl> and C will quit out of the program.
  39.  
  40. The User-Definable Options
  41. ==========================
  42.  
  43.   Despite its complicated title, they really are quite simple to alter.
  44. The first thing it will ask is :
  45.  
  46. Enter zoom level (400 = norm)
  47.  
  48.   For this, you may alter it as much as you wish (within reason),
  49. but if you do put in a very large or very small number then you will 
  50. hardly see the kite. (I forgot to mention this, but it works out how 
  51. the light is reflected off the lines and the kite, so sometimes you may
  52. not see the kite and/or the lines. This is perfectly normal, so don`t
  53. worry - it hasn`t crashed: look at the x/y figures to see if it's still
  54. working.) Level 400 Zoom is quite good.
  55.  
  56. Enter distance (500 = norm)
  57.  
  58.   This is the distance away from the kite (in metres) you are standing.
  59. This works in harmony with the zoom for your final viewing position. I
  60. quite like 500m as it puts you it a good position along with 400z level.
  61.  
  62. Enter time (s)
  63.  
  64.   This is the total time that the kite will be in the air in seconds. 
  65. It will keep looping until the counter expires (or until you press the
  66. left mouse button).
  67.  
  68. Enter limit * factor (2 = norm)
  69.  
  70.   Until you get familiar with the kites' limitations I suggest that
  71. you leave this at 2. It goes from two to four and adjusts the kites'
  72. movements very slightly.
  73.  
  74. Enter kite flexibility (1 = norm)
  75.  
  76.   Do you want your kite to be a well `ard rigid delta or a sexy
  77. flexifoil? Well, this goes from one to over five but I only recommend 
  78. going up to five. Bear in mind that a delta-wind with standoffs is rigid
  79. (1), without standoffs is slightly flexible (2), all eddy/trilby
  80. (diamond-shaped) kites are rigid (1), parafoils go from 2 to 4, sharkfins
  81. from 2 to 5 and flexifoils are 5 (immensely flexible!).
  82.  
  83. Enter wind speed (0 = Random)
  84.  
  85.   Wind speeds from 3 to 10,000,000,000 (!) mph are supported. Anything
  86. less than 3 will result in an error. Enter 0 mph for a random windspeed
  87. up to 30 mph.
  88.  
  89. Nightflight (1=Yes, 0=No)
  90.  
  91.   Nightflight darkens the sky and adds an impressive starfield. A bug
  92. means that it adds a starfield anyway!
  93.  
  94. Delta-wing (1=Yes, 0=No)
  95.  
  96.   This option works in conjunction with the next to work out what sort
  97. of kite it is. Enter a 1 here for a delta wing or a sharkfin, or a 0
  98. for an eddy/trilby, a parafoil or a flexifoil.
  99.  
  100. S'division of s'face vectors (2-8)
  101.  
  102.   Now, this is the interesting bit. If you put in 40 here it would
  103. result in an error. If I had just left it, you would have ended up
  104. with a kite several miles across! Here is a table to show you what
  105. sorts of kites you get with combinations of the previous two options:
  106.  
  107. Kite type    |   Delta-wing   |   Vectors
  108. -----------------------------------------
  109. Eddy/Trilby  |        0       |      2
  110. Std Delta    |        1       |      2
  111. Parafoil     |        0       |     3-8
  112. Flexifoil    |        0       |      7
  113. Sharkfin     |        1       |     3-8
  114.  
  115. The next bit
  116. ============
  117.  
  118.   After pressing return after the vectors you can select one of three
  119. modes to display your kite in:
  120.  
  121. Left Mouse   -  Low-res Standard
  122. Right Mouse  -  Hi-res Interlaced (My favourite for kiting)
  123. Space-bar    -  Hi-res Standard
  124.  
  125.   After this, your kite will appear, floating gracefully around the
  126. sky. There are some numbers in the top corner. The x/y co-ordinates
  127. are the only ones that change. The rest are statistics about your kite
  128. (except the area one. That doesn't work in this version.).
  129.  
  130.   You may press the mouse button to get out of this at any time, but
  131. it may start printing unexpectedly.
  132.  
  133.   When the `bird has flown', a screen will come up and if you decide
  134. to print, the following info will be on your piece of (hopefully)
  135. recycled tree pulp (paper):
  136.  
  137.  The version number of the program
  138.  
  139.  The flexibility and type of the kite
  140.  How long it was airborne
  141.  The recommended minimum line strength and the average wind speed
  142.  The kites' maximum speed (doesn't work for deltas or diamonds, sorry!)
  143.  The area of the kites' sail
  144.  The strain on the Rip-Stop nylon fabric
  145.  The maximum wind speed
  146.  
  147.  What time the kite was flying
  148.  
  149. Here is an example printout:
  150.  
  151.  KiteSim v2.42 (c) R. Boardman of Wavelength Software 1993
  152.  Current Kite Status Report
  153.  
  154.  This kite is a flexible sharkfin.
  155.  It was in the air for 44 seconds.
  156.  The recommended line strength for this kite in winds of 50 mph is 250lb.
  157.  It reached a maximum speed of 100 mph (160.93 km/h).
  158.  The area of this kite is 4 square metres or 37.2 square feet.
  159.  The strain on the fabric was 75 psi.
  160.  There were gusts of up to 85 mph.
  161.  
  162.  The kite was flying during the night at 11:53pm
  163.  
  164. What is to be expected?
  165. =======================
  166.  
  167.   In future versions there shall be:
  168.  
  169.   * Fixed bugs
  170.  
  171.   * Max speed indicators for smaller kites
  172.  
  173.   * Wireframe version (for speedy flights)
  174.  
  175.   * Added support for other forms of kite (if there are any)
  176.  
  177.   * Annoying tune that only stops playing when you are on the verge of a
  178.     nervous breakdown after listening to it for three weeks
  179.  
  180.   * A 3D Kite Designer
  181.  
  182.   * NTSC Support
  183.  
  184.   * An AGA version (maybe)
  185.  
  186.   * A faster version
  187.  
  188.   * User-controllable kites
  189.  
  190.   * Anything else I can think of
  191.  
  192.   * And all your suggestions
  193.  
  194. Other notes
  195. ===========
  196.  
  197.   Unfortunately, I couldn`t get hold of a 500 to try it on, so I only
  198. know for sure that it works on WB3.0 machines with at least 2Mb of mem,
  199. but theoretically it should work with less. (* marks versions on this
  200. disk.)
  201.  
  202. Version history
  203. ===============
  204.  
  205.  v1.0          The original - no user-definable options or stats or
  206.                printouts. Lowres only. No nightflight. Eddy kites
  207.                only. No lines
  208.  
  209.  v1.1          Hires added.
  210.  
  211.  v1.15         Hires laced added.
  212.  
  213.  v1.2          Zoom level changeable. Kite lines added
  214.  
  215.  v1.3          Distance changeable. Vectors added.
  216.  
  217.  v1.4          Time counter + stats added.
  218.  
  219.  v1.5          Limit + flex factor added. Surface light added. 
  220.  
  221.  v1.6          Further stat support.
  222.  
  223.  v1.7          Windspeed added. Parafoil support added
  224.  
  225.  v1.75         Random windspeed added.
  226.  
  227.  v1.8          Flexifoil support added.
  228.  
  229.  v1.9          Delta-wing and sharkfin support. First ß Release.
  230.  
  231.  v2.0          Small printer support added.
  232.  
  233.  v2.1          Extended printer report.
  234.  
  235.  v2.2          Bugs fixed (some).
  236.  
  237.  v2.3          Nightflight added. One bug added!
  238.  
  239.  v2.4          Best printer support.
  240.  
  241. *v2.41         Refused to work on a 2Mb A1200. (Tell me if you get it
  242.                to work andhow, please!)
  243.  
  244. *v2.42         Over 200% acceleration and first real (gamma) release.
  245.  
  246.   If you like this prog, please send £1.50 to me, Rick Boardman, at:
  247.  
  248.                41, Roylen Ave,
  249.                Carleton,
  250.                Blackpool,
  251.                Lancashire,
  252.                ENGLAND.
  253.                FY6 7PH
  254.  
  255.   I will register you as a user and you will be informed of all major
  256. updates and get one free if you send back your disk to me.
  257.  
  258.   If you want the source code in AMOS (yes, I swear by it!) then please
  259. send another £2.50.
  260.  
  261.   This program was written in AMOS Professional and begun a few weeks ago.
  262. It took a lot of my time (and a lot of my hair!) to write. So please,
  263. have some sympathy!
  264.  
  265. (You may also send bug reports, cars, computers, bikes, sofas, MONEY,
  266. kites, guitars, anything really to the above address.)
  267.  
  268. Copying notice
  269. ==============
  270.  
  271.   This prog isn`t quite shareware, as it is still in it`s early days,
  272. but I would still appreciate a donation. If you copy it to all of your
  273. friends, make sure you still leave the program and this document
  274. intact. 
  275.  
  276. Disclaimer
  277. ==========
  278.  
  279.   Now, listen up. If you are watching a vector kite scream around the 
  280. air in eight million mile per hour winds, and there is a power cut,
  281. causing all the stored current to leap back into the plug and melt the 
  282. 1p coin you replaced the fuse with, making a billion volt jump back
  283. through the United Kingdom and causing a small but heavily populated
  284. part of Bognor Regis that lies across an undiscovered fault line to drift
  285. off into the ocean and sink, then it`s not my fault. In other words, I
  286. accept no responsibility for anything bad that happens using this program,
  287. directly or indirectly. Cheers!
  288.  
  289.  
  290.                                                        Rick Boardman
  291.                                                        22nd Aug 1993
  292.  
  293.